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but yes—Ajax will power some 
exciting new cross-browser busi¬ 
ness applications, but at the same 
time, we're going to see desktop 
applications get jaw-dropping 
amazing. Time will tell which ver¬ 
sions the market prefers. 


creation of incredibly easy-to-use 
frameworks that make Ajax easy. 

Prototype, Scriptaculous, dojo, 
DWR for Java folks, JSON for pret¬ 
ty much any language and many 
other tools can make it so easy to 
do all kinds of great Ajax effects. 

And, the server-side frame¬ 
works have already started to 
build Ajax right in, and will con¬ 
tinue to do so. In the coming 
years, server-side developers will 
probably do some pretty amaz¬ 
ing Ajax without writing much 
of any JavaScript at all. 

LJ: Are there new security 
risks associated with Ajax 
development? 

BG: Nothing fundamental, 
though there are a few exploits 
here and there that arise as we 
push the browsers in a new 
direction. However, I should 
mention Greasemonkey. 

I hate Microsoft Money, and 
any other personal finance pack¬ 
ages I've used. On the surface, 


on other Web sites. 

While we've all known for 
ages that anything you send 
in HTML can be hacked and 
that our server endpoints 
need to be prepared to receive 
all kinds of malformed requests, 
as Ajax pushes more logic to 
the client, some of us may 
forget that lesson, and tools 
like Greasemonkey make it trivial 
for people to take advantage of 
poorly written applications. 

Talk about exciting—finally, the 
ability for a community to take a 
commercial, off-the-shelf app and 
modify it easily to do all kinds of 
new things. You might argue that 
open source has empowered that 
for years, but the Greasemonkey 
concept takes that to a whole new 
level—a whole new audience that 
doesn't know how to use CVS, 
gcc, C++ and so on. 

Ajax doesn't introduce new 
security risks, but it may facilitate 
the creation of insecure Web sites. 


LJ: What are some good 
resources for our readers who 
are interested in learning? 

BG: Some folks have said favor¬ 
able things about our own site, 
Ajaxian.com, being a good 
resource. Dion Almaer—my 
Ajaxian partner and the site's 
editor—does a really good job of 
putting new information on the 
site daily. You'll definitely keep 
up with what's happening! 

For the Ajax newbie, there are 
some great books coming out 
from all of the publishing houses, 
such as Ajax in Action from 
Manning, Ajax Foundations from 
Apress and more. Dion and I have 
got one coming out too: Pragmatic 
Ajax, published by the Pragmatic 
Press. My favorite bit in that book 
is a chapter where we walk you 
through building your own version 
of Google Maps from scratch. 

LJ: Thanks for the opportuni¬ 
ty to talk with youla 
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Rapid GNOME Development 
with Mono 

How to get started with GNOME monkeyshines using the open-source .NET system Mono. 

ROBERT LOVE 


Mono is an open-source implementation of the .NET development 
platform, a powerful and now open development platform. Mono 
contains a number of components: a Common Language Infrastructure 
(CLI) virtual machine, a C# compiler and a set of class libraries. Mono 
implements the C# language and runtime environment according to 
ECMA standards 334 and 335, respectively. 

Mono—which is the word for monkey in Spanish—provides various 
class libraries, including an open-source implementation of the .NET 
Framework SDK. In this article, however, we discuss one of Mono's 
brightest assets: its GNOME support, in the form of Gtk#. 

Gtk# is a .NET language binding for the Gtk+ toolkit and various 
other GNOME libraries. More than a simple wrapper, Gtk# provides a 
powerful platform for developing GUI software in the GNOME environ¬ 
ment. Gtk#'s language bindings utilize good object-oriented principles 
and C#-style design to make GNOME development easy and natural, 
yet flexible and powerful. 

In this article, we investigate the construction of a simple C# appli¬ 
cation, starting with a trivial "Hello, World" application and building it 
into a basic Wikipedia search tool. Our only dependencies will be 
Mono and Gtk#. Packages are available for most distributions—see the 
on-line Resources. 

Hello, World! 

Let's start by constructing the most basic Mono application possible, 
which prints "Hello, World!" to the console: 

using System: 
class first { 

public static void Main (string!] args) 

{ 

Console.WriteLine ("Hello, World!"); 

} 

} 

Fire up your favorite editor, enter this code and save it as first.cs. 

We can then compile the program into an executable image with 
the following: 

$ mcs first.cs 

Finally, we can run it via the following command: 

$ mono first.exe 


Hello, World! 

This application implements the first class. Every application needs 
an entry point, an initial function inside of the class for the Mono run¬ 
time to jump to and begin the program's execution. As with C and 
C++, this is the Main function. The prototype of this function is: 

public static void Main (string!] args) 

In our program's Main, we invoke a single function, WriteLine, 
which is found inside the Console class. This function, similar to 
printfO, writes a line of text to the console. It can be used to output 
the values of variables too: 

int x = 5; 

String s = "wolf"; 

Console.WriteLine ("x={0} s={l}", x, s); 

This gives us: 
x=5 s=wolf 

Hello, World! in Color 

We do not, however, have to confine our "Hello, World!" to the con¬ 
sole; with Gtk#, we can build a trivial GUI dialog to hoist our message 
onto the world: 

using System: 
using Gtk; 

class Two { 

static void WindowDelete (object o, DeleteEventArgs args) 

{ 

Application.Quit (); 

} 

static void InitGui () 

{ 

Window w = new Window ("My Window"); 

HBox h = new HBox (); 
h . BorderWidth = 6; 
h.Spacing = 6; 
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w.Add (h); 

VBox v = new VBox (); 
v.Spacing = 6; 

h.PackStart (v, false, false, 0); 

Label 1 = new Label ("Hello, World!"); 
l.Xalign = 0; 

v. PackStart (1, true, true, 0); 

w. DeleteEvent += WindowDelete; 
w.ShowAll (); 

} 

public static void Main (string[] args) 

{ 

Application.Init (); 

InitGui () ; 

Application.Run (); 

} 

} 

As before, enter the code via your favorite editor. This time, save it 
as two.cs. To compile this program, we need to tell the Mono compiler 
that we want to use the Gtk# assembly: 

$ mcs two.cs -pkg:gtk-sharp 

Running it, however, is the same: 

$ mono two.exe 

The application creates a small window, titled My Window, and 
writes "Hello, World!" into the window (Figure 1). The window is a 
GtkWindow, the label a GtkLabel. Gtk lays out windows via boxes. 
Boxes are invisible widgets—existing solely for the purpose of layout— 
into which other widgets are packed. The arrangement of widgets 
within a box determines the physical layout of the widgets within the 
window. Although it is possible in Gtk to arrange widgets using tables, 
most programmers prefer boxes for their flexibility and power—plus, 
once you get the hang of them, they are not difficult to use. 

Gtk provides two types of boxes: vertical and horizontal. A vertical 
box, called a vbox, defines the vertical arrangement of widgets—vbox- 
es arrange widgets into columns. A horizontal box, known as an hbox, 
defines the horizontal arrangement of widgets, by arranging them into 
rows. Widgets are packed into boxes, boxes are packed into other 
boxes, and the boxes are added to windows. 

A new hbox is created via: 

HBox h = new HBox (); 

And a new vbox is created via: 

VBox v = new VBox (); 

The new objects representing the boxes have various properties 
that one can set to manipulate the look and feel of the box. In our 




Figure 2. The Fancy GUI 


previous example, we set two properties on the hbox: 

h.BorderWidth = 6; 
h.Spacing = 6; 

Here, we set the border of and the spacing around the hbox to 
six pixels each. This provides a net spacing of 12 pixels around the 
hbox. Coincidentally, for purposes of aesthetics and consistency, 
the GNOME HIG (Human Interface Guideline) dictates a minimum 
spacing of 12 pixels between widgets—thus the six and six pixels 
in this example are perfect. 

To add a box to a window, the Add() member function is called on 
the window in question and provided to the box: 

w.Add (h); 

To pack a widget into a box, the PackStartO member function is 
called on the box in question: 

public void PackStart (Widget child, 
bool expand, 
bool fill, 
uint padding) 

In our example, we did: 

v.PackStart (1, true, true, 0); 

This call packs our label into our vbox. If the expand parameter 
is true, the widget child expands to fill all available space within the 
box. If the fill parameter is true, the widget consumes all of its 
space for rendering; otherwise, if false, the widget uses superfluous 
space for padding. The padding parameter allows for the addition 
of extra spacing around the widget, within the box, beyond any 
padding already provided. 

Starting our application is simple. We perform three simple steps: 

Application.Init (); 

InitGui (); 

Application.Run (); 

Application.Init() initializes Gtk# and the application's GUI. It should 
be one of the first functions that a Gtk# application invokes. After 
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executing this function, applications set up their GUI, create and 
arrange their widgets, and draw the initial windows and other 
Ul elements. In our program, we do this in the InitGuiO function. 

Once everything is complete and ready to roll, the program calls 
Application.Run() and the race is off. Our main window pops up 
because we exposed it, back in InitGuiO, via: 

w.ShowAll (); 

This exposes the window and all widgets packed therein. Thus, once 
the application invoked Application.Run(), our Ul elements appear. 

While executing, the program's responses are handled by the 
behavior of widgets. Some widgets behave in predetermined ways, not 
requiring the programmer to write any code manually. Most of the 
time, however, the programmer wants to handle events personally. This 
is done by writing an event handler, using the incredibly useful C# 
events feature, that Gtk# invokes in response to widget interaction. 

In our last example, we have one such event handler. We want our 
application to exit when the user clicks the close box on the main win¬ 
dow, so we need to handle the associated event, which is called 
DeleteEvent. This is done by writing the event handler: 

static void WindowDelete (object o, DeleteEventArgs args) 

{ 

Application.Quit (); 

} 

And adding it as an event handler: 
w.DeleteEvent += WindowDelete; 

The function Application.Quit() causes Gtk# to destroy the Ul, 
shut down and terminate the application. Consequently, when the 
user clicks the close box on the main window, our application 
gracefully exits. 

Building a Better Example 

Let's turn now to building a more complete—dare I say useful— 
application: a tool for searching Wikipedia. To be sure, we will not 
build anything fancy, but we can implement something fun. Let's 
look at building a simple window, with a text-entry widget. We 
will allow the user to type a search query into the window and 
click a button (Figure 2). The application then launches the user's 
Web browser and looks up the search term on Wikipedia. We build 
the whole thing, including the GUI and code to launch the Web 
browser, in only a handful of lines. 

We can construct this new application by building on our last 
example, adding new widgets and the requisite features. Surprisingly, 
thanks to Gtk#, the additional code is not very much! Here we go: 

using System; 
using Gtk; 

class Example { 

public static Entry search_entry; 

public static void ButtonClieked (object o, EventArgs args) 
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{ 

String s = 

"http://en.wikipedia.org/wiki/Special:Search?search= w ; 
s += search_entry.Text; 
s += "&go=Go"; 

Gnome.Url.Show (s); 


static void WindowDelete (object o, DeleteEventArgs args) 

{ 

Application.Quit (); 

} 

static void InitGui () 

{ 

Window w = new Window ("Wikipedia Search"); 

HBox h = new HBox () ; 
h.BorderWidth = 6; 
h.Spacing = 6; 
w.Add (h); 

VBox v = new VBox (); 
v.Spacing = 6; 

h.PackStart (v, false, false, 0); 

Label 1 = new Label ("_Search:"); 
l.Xalign = 0; 

v.PackStart (1, true, false, 0); 

v = new VBox (); 
v.Spacing = 6; 

h.PackStart (v, true, true, 0); 

search_entry = new Entry () ; 
search_entry.ActivatesDefault = true; 

1.MnemonicWidget = search_entry; 
v.PackStart (search_entry, true, true, 0); 

v = new VBox (); 

v. Spacing = 6; 

h.PackStart (v, true, true, 0); 

Button b = new Button ("Search"); 

b.CanDefault = true; 

w. Default = b; 

v. PackStart (b, true, true, 0); 

b.Clicked += ButtonClieked; 

w. DeleteEvent += WindowDelete; 
w.ShowAll (); 


public static void Main (string[] args) 

{ 


Application.Init (); 

InitGui (); 

Application.Run (); 

} 

} 

We need to add a new assembly, gnome-sharp, to our compiler 
command line. Assuming you name this program three.es, you would 
perform the following: 

$ mes three.es -pkg:gtk-sharp -pkg:gnome-sharp 

And now run it via: 

$ mono three.exe 

This third and final program contains a few new widgets—but¬ 
tons, labels and text entries—but follows the same basic structure 
as our second program. If we work backward, from the last box 
outward to the first, we can get a good feel for the layout of the 
Ul elements without even seeing a screenshot. 

The other big difference is a new event, Clicked. We define a 
function and add it as an event handler: 

b.Clicked += ButtonClieked; 

We made the text-entry widget, search_entry, public, and thus our 
new event handler can grab the contents of the search entry when the 
user presses the button via search_entry.Text. 

In ButtonClicked, we grab this text, construct the Wikipedia URL 
required for searching for the text, and use the Gnome.Url.Show() 
function to open the user's preferred Web browser (a global GNOME 
setting) and send it off to our URL. 

Conclusion 

Although it is impressive to implement so much in so little, the real 
boon is that this is a C-like language, not a scripting language. C# 
retains much of the power and performance of C and adds powerful 
object-oriented programming constructs. 

Let me be frank. I am a C programmer. I spend most of my 
days hacking the kernel. Higher-level languages are not my cup of 
tea. Indeed, I am no fan of C++ or Java. Yet, having spent time 
with C#—working on Beagle, among other C# endeavors—I am 
thoroughly impressed. C# is an elegant language that readily 
makes clear an obvious facet: it is quite well designed. 

In Mono, we have a free and open C# compiler, runtime and family 
of libraries, supported by a vibrant Open Source community. Although 
excellently paired with GNOME development, Mono is a smart tool for 
many jobs. 

Resources for this article: www.linuxjournal.corn/article/8750.H 


Robert Love is a senior kernel hacker in Novell’s Ximian Desktop group and the author of Linux Kernel 
Development (SAMS 2005), now in its second edition. He holds degrees in CS and Mathematics from the 
University of Florida. Robert lives in Cambridge, Massachusetts. 
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Stealth E-Mail to the Rescue 


How to use stealth e-mail with dynamic DNS and a Treo 650 smart phone, peter ziobrzynski 


Since the early days of e-mail, 

maintaining my own e-mail server was a 
sort of indication of being in charge and 
staying technically fit. The technology 
involved in a project like this usually includes 
components that can be reused elsewhere 
and force one to stay abreast with commonly 
used communications media. 

In the beginning, it was a simple task 
of connecting a modem, finding a commu¬ 
nity UUCP server, configuring modem dial¬ 
up, uucico and Sendmail. This was sort of 
the Model T of e-mail. And, it usually 
included configuration of a Usenet feed 
with C-News to collect the UUCP addresses 
of all computers on the relatively small 
Internet at that time. 

With the advent of the real Internet, the 
scenario is becoming more complex. You 
have to overcome a number of obstacles 
created by people trying to break in to your 
server, snoop the transmission of e-mail pack¬ 
ets on the wire and deal with those who 
want to send you tons of unwanted e-mail. 

As if this were not enough, workplaces have 
become so secure that it is sometimes impos¬ 
sible to access your personal e-mail server 
over the Internet from work during the day. 

I used to maintain a Linux server with a 
static IP on a DSL line running DNS, a firewall 
(netfilter) with my MTA of choice (Postfix) and 
the addition of SpamAssassin for spam filter¬ 
ing. I read e-mail on my laptop using IMAP 
with Netscape Communicator. I use 
Communicator filters to sort all my incoming 
mail into various IMAP folders. 

This simplistic architecture became history 
this summer after moving out of the San 
Francisco Bay Area to Denver, Colorado. The 
luxury of a static-IP DSL vendor disappeared, 
and a Nazi-style ISP with a monopoly in the 
area became a reality. Static IP is not available 
here (at least for me), and the ISP uses 
aggressive filtering of the commonly used IP 
ports. My new workplace is so secure that I 
had forgotten about carrying my laptop with 
me or using my work Internet connection to 
get to my e-mail server. All this is understand¬ 
able, as ISPs protect themselves from spam¬ 



mers and employers need better security. But, 
I still want to read my e-mail during the day. 

I took it as a personal challenge to over¬ 
come these obstacles. The direction I went 
was to use the smart phone Treo 650 as a 
personal e-mail reader to bypass the work¬ 
place security. I configured my home e-mail 
server to use new stealth-mode ISPs that 
allow for dynamic DNS and mail relays to 
ports of choice. 

Here is a summary of the configuration 
components that I cover in step-by-step con¬ 


figuration details below: 

■ The e-mail server is running stable Gentoo 
Linux connected to the Internet via VDSL 
(very high-speed DSL from Qwest), using a 
DHCP-assigned dynamic-IP address. My 
DNS domain registrar is No-IP.com. This 
registrar uses a custom dynamic DNS setup 
that detects IP address changes on my 
side. This is done by running a custom 
client program on my server—noip2 client 
connects to the No-IP.com registrar DNS 
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server and updates my DNS records in as often as one-minute inter¬ 
vals. This is called Plus Managed DNS. 

■ Because my ISP blocks incoming IP port 25, I use the Mail Reflector 
No-IP.com service that sets an MX record for my domain to its own 
server and delivers the mail to a custom port on my server. 

■ My ISP also lists my DHCP addresses with the Internet spam black¬ 
lists, so any attempt to deliver e-mail directly from my server is 
doomed to failure. To overcome this, I use the No-IP.com service 
called Alternate-Port SMTP, which acts as an outgoing mail relay. I 
punt all mail to a No-IP.com server using SSL authentication and also 
a custom port in case my ISP blocks outgoing SMTP. 

■ My MTA is Postfix, which is quite handy for the stealth configura¬ 
tion with alternate incoming and outgoing ports. 

■ I use SpamAssassin to filter spam. It is easy to configure and works 
very well. In brief, its function is limited to processing mail messages 
and attaching a custom mail header field—an X-Spam-Level rating 
to each message as spam candidates. The level of spam likelihood is 
measured by the number of asterisks this field contains. A single * is 
usually a good indication of spam. 

■ I could not count on storing e-mail on my smart phone and filter¬ 
ing it there. The phone couldn't handle that much e-mail. So I 
replaced the client-side Netscape Communicator filter function (to 
sort incoming mail into IMAP folders) with Procmail. I created a 
.procmailrc file implementing all spam and mailing-list rules to file 
messages in the folder hierarchy on the server. This proved to be 
quite useful and opened the access to my archived e-mail from 
any location. 

■ The IMAP server was quite a problem for me. I prefer traditional 
mailboxes where multiple messages are stored in a single file per 
folder. Most modern IMAP servers, like Courier or Cyrus, use mod¬ 
ern maildir or MH formats, which store each message in its own 
file. This consumes an insane amount of i-nodes. Unfortunately, the 
only open-source IMAP server I could find that uses traditional fold¬ 
ers is the uw-imap. (CommuniGate Pro uses single files, but it's a 
commercial server.) The uw-imap server has a number of drawbacks, 
especially when it comes to SSL-protocol implementation. My tests 
of uw-imap with the SSL IMAP client that I had in mind for this pro¬ 
ject (PalmOS VersaMail) showed failed connections or flat failures to 
connect. To get what I want—the single file mail folders and working 
SSL—I split the function of IMAP and SSL over two separate servers: 
stunnel and uw-imap. Stunnel proved to be quite sophisticated in the 
SSL configuration and level of logging and diagnostic messages. 

■ The client side of my e-mail configuration originally included stock 
PalmOS VersaMail shipped with the Treo 650 and part of a Sprint 
plan. The key factor in this decision was availability of unlimited use 
of Internet connectivity for a flat $15 US per month fee. The 
VersaMail IMAP support is quite good, and integration with the 
Blazer Web browser made the sale for me. Unfortunately, a more- 
intense use of the VersaMail uncovered problems with its operation. 
The whole setup depends on a reliable mail server polling for new 


mail. Unfortunately, VersaMail has a bug that impacts scheduling of 
the polling, and this makes it rather ineffective. I ended up using 
the SnapperMail mail client for PalmOS, which is a good example of 
how nine guys in New Zealand can outrun a big corporation like 
Palm Software. SnapperMail is one of the best PalmOS applications I 
have used so far. 

There are quite a number of moving parts here, and a diagram is in 
order (Figure 1). 

As you can see from Figure 1, there are three main areas of config¬ 
uration: Linux server, No-IP.com services and the Treo 650 mail client. 

Linux Server Configuration 

My selection of the Gentoo Linux distribution for the project was dic¬ 
tated by the very convenient Portage package management. Portage 
completely frees the user from hunting down required packages. In 
operation, it resembles Perl CPAN or Debian apt-get. For installation of 
Gentoo itself, refer to the gentoo.org Web site. The installation of the 
OS is mostly manual, and it can be a rather lengthy process (some 
installations even can take days, because you compile everything your¬ 
self), but this investment will pay itself back during server management 
and application configuration. 

You also need to get the DNS and SMTP services from No-IP.com, 
mentioned above. The No-IP.com Web site provides documentation for 
all services they provide. 

The instructions that follow are Gentoo-specific, but it should be 
fairly easy to adapt this project to a different distribution. You simply 
need to make sure that the applications you install have the capabilities 
(like SASL) used for this solution. 

Postfix MTA 

We begin installation with the core component, Postfix. Standard 
Gentoo installation comes with a simple MTA ssmtp that needs to be 
removed before Postfix installation. Also, Postfix needs to be installed 
(compiled) with SASL support. This is needed for authenticated mail 
delivery to the No-IP.com relay host (Alternate-Port SMTP service). 

The SASL option is turned on with the sasl keyword added to the 
Gentoo USE configuration variable. In /etc/make.conf, add: 

/etc/make.conf: 

USE="sasl" 

Install SASL libraries: 

# emerge dev-libs/cyrus-sasl 

Now remove and add MTAs: 

# emerge -C ssmtp 

# emerge postfix 

Add init rc script startup: 

# rc-update add postfix default 

Postfix configuration is relatively simple—two configuration files in 
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/etc/postfix need attention: main.cf and master.cf. 

Change the information describing your gateway host by editing 
the main.cf file for Postfix. Here, the hostname of your gateway is 
mygateway, and the domain name is foobar.net. The relay host that 
you will send all your mail to is relayhost.no-ip.com, receiving SMTP on 
port 1234. Both will be provided by No-IP.com as part of the Alternate- 
Port SMTP service: 

myhostname = mygateway 
mydomain = foobar.net 
myorigin = $mydomain 

mydestination = $myhostname, localhost.$mydomain $mydomain 
#home_maiIbox = .maildir/ 
relayhost = relayhost.no-ip.com:1234 
smtp_sasl_auth_enable = yes 

smtp_sasl_password_maps = hash:/etc/postfix/saslpass 
smtp_sasl_security_options = 

Add an extra port (4321) beside 25 to the Postfix master.cf file. 

This will be used to receive SMTP from the Mail Reflector No-IP.com 
service and also your Treo 650: 

4321 inet n - n - - smtpd 

Create an SASL password file /etc/postfix/saslpass for host 
relayhost.no-ip.com and user foobar.net@noip-smtp using password 
????—all provided by No-IP.com: 

/etc/postfix/saslpass: 

relayhost.no-ip.com foobar.net@noip-smtp:???? 

Next, generate a dbm map: 

# cd /etc/postfix 

# postmap saslpass 

As a final touch, you need to enable e-mail relaying from your Treo 
650. We use Sprint here, and you will have to find out what Sprint 
switch IP range will be connecting to your server. The Postfix main.cf 
parameter mynetworks will have to include the network address of the 
switch. I use 70.0.0.0/8 beside my home network and a local loop net¬ 
work. It is always best to narrow the range of addresses as much as 
possible, for security reasons: 

mynetworks = 192.168.1.0/24 127.0.0.0/8 70.0.0.0/8 

Spam Filter 

You need to install two packages: spamassassin and procmail. The 
steps (for Gentoo) are as follows. 

Install Procmail: 

# emerge procmail 

Install SpamAssassin: 

# emerge spamassassin 


Update the init rc scripts to start the SpamAssassin server (this is 
probably done for you if you use a different package manager): 

# rc-update add spamd default 

Adjust your Postfix configuration to deliver all mail using Procmail. 
Add this to /etc/postfix/main.cf: 

mailbox_command = /usr/bin/procmai1 

Create the main Procmail configuration file/etc/procmailrc, and add 
this recipe to make e-mail pass through SpamAssassin: 

DEFAULT=/var/spool/mai1/$L0GNAME 
:0fw: spamassassin.lock 

# < 256000 

| /usr/bin/spamc 

Start the spamd server: 

# /etc/init.d/spamd start 

Mail Filing 

Establish an IMAP folder hierarchy and Procmail configuration file to 
file mail in those folders. If you have multiple users, you have to do this 
for each user. The following configuration uses ~/.m for the folder root 
directory. The per-user Procmail configuration file is located in 
-/.prcmailrc. I use the following .procmailrc file template that imple¬ 
ments the essential functionality of separating spam from mail and 
filing mailing lists. For details, refer to procmailrc(5): 

PATH=/bin:/usr/bin:/usr/sbin 
MAILDIR=$HOME/.m 
DEFAULT=$MAILDIR/Mbox 
LOGFILE=$HOME/.procmail.log 
VERBOSE=yes 

# File gentoo-user mailing list into -/.m/lst/gentoo 
: 0 : 

# ( A To.*| A Cc.*)gentoo-user@lists.gentoo.org 
Ist/gentoo 

# File jobserve mail into -/.m/lst/jobserve 
: 0 : 

# A From.*jobserve.com 
1st/jobserve 

# File SPAM into -/.m/Spam with some exceptions: 

: 0 : 

# A X-Spam-Level: . *\* 

* ! A From.*netflix 

* ! A From.*vail 

* ! A From.*ebay member 

* ! A From.*cnet 
Spam 

# File SPAM that escaped spamassassin: 
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: 0 

# A From.*eversave.com 
Spam 

:0: 

# A From.*sears.com 
Spam 

Now that the mail processing facilities are in place, you can start 
Postfix and let the mail start flowing in; I can almost guarantee that 
the first folder with mail will be your ~/.m/Spam: 

# /etc/init.d/postfix start 

IMAP Server 

The IMAP configuration includes a stunnel SSL front end and the 
uw-imap back end. The installation for uw-imap is a bit nonstandard, 
because the default Gentoo configuration does not allow you to build 
uw-imap with clear-text authentication over an unencrypted channel. 
The only default uw-imap configuration that works is the one with SSL 
support. This is not what we need as a server behind stunnel. Gentoo 
lets you remedy this with a special USE setting to disable SSL and 
enable clear-text passwords. 

The installation command for Gentoo is: 

# USE="-ssl clearpasswd" emerge uw-imap 

Next, the stunnel configuration file stunnel.conf needs to include 
an IMAP section. Edit/etc/stunnel/stunnel.conf: 

pid = /var/run/stunnel/stunnel.pid 

socket = 1:TCP_N0DELAY=1 

socket = r:TCP_N0DELAY=1 

cert = /etc/ssl/certs/foobar.net.pern 

[imaps] 

accept = 993 

exec = /usr/sbin/imapd 

execargs = imapd 

You can generate a self-signed SSL certificate for foobar.net.pern 
with the following commands: 

# cd /etc/ssl/certs 

# openssl req -new -x509 -nodes -out cacert.pem -keyout cakey.pem -days 5000 

Country Name (2 letter code) [AU]:US 

State or Province Name (full name) [Some-State]:C0 

Locality Name (eg, city) []:Highlands Ranch 

Organization Name (eg, company) [Internet Widgits Pty Ltd]: 

Organizational Unit Name (eg, section) []:home 

Common Name (eg, YOUR name) [] :foobar.net 

Email Address []:me@foobar.net 

# cat cakey.pem cacert.pem > foobar.net.pern 

With Gentoo, you must now configure the init rc scripts to 
start stunnel: 

# rc-update add stunnel default 


The Treo 650 Setup 

As I mentioned, there are two good IMAP clients available for PalmOS. 
One is the standard application included with the Treo, VersaMail. The 
other is a commercial application, SnapperMail. My choice was the lat¬ 
ter, even in spite of its relatively high cost (approximately $60 US). 

Both applications allow for subscribing to a hierarchy of IMAP 
folders on the server and handling e-mail attachments. SnapperMail 
is definitely better tested and has a number of features that justify 
its additional cost. 

To install PalmOS applications and generally manage my Treo 650 
using Linux, I use pilot-link software. On Gentoo, install it with: 

# emerge pi lot-link 

I use pilot-link to back up and restore my Treo to a directory on 
Linux as well as to install applications like SnapperMail. 

I use Bluetooth and PPP to connect my Treo to a Linux notebook. 
You also can use a USB connection. The connection channel for 
pilot-link tools is conveniently defined with a PILOTPORT environment 
variable. Use the following for a USB cable: 

# export PIL0TP0RT=/dev/tts/USBl 
or for Bluetooth, use: 

# export PIL0TP0RT=net:any 

I create a directory named treo in my home directory, and run this 
command to back up my Treo before installing any software: 

# pilot-xfer -b treo 

I use the following command to synchronize (incrementally) the 
Treo with this backup directory: 

# pilot-xfer -s treo 

To restore a backup, use the following: 

# pilot-xfer -r treo 

Download SME231.zip from www.snappermail.com to install the 
SnapperMail application. Unzip the file and run this command: 

# pilot-xfer -i SnapperFlai 1 -ent. prc 

The configuration of the Treo 650 with the Sprint network is best 
done by ordering the Sprint PCS Vision Professional Pack and letting 
Sprint support walk you through the setup. 

SnapperMail also comes with a good 60-page PDF manual, and its 
setup is really quite intuitive. ■ 


Peter Ziobrzynski is an Independent Consultant based in Toronto, Canada, providing UNIX and Linux con¬ 
sulting services to clients in San Francisco, California, and recently in Denver, Colorado. Peter holds a 
Master’s degree in Engineering from Cracow University of Technology, Poland. He immigrated to Canada 
in the early 1980s and has been using UNIX since then for work and pleasure. His recent focus is on 
Linux, and he holds Red Hat RHCE. 
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Subversion: Not Just 
for Code Anymore 

Here is a subversive way to handle multiple versions of your 
personal information instead of just versions of code, william nagel 


Have you ever needed some information from a file, only to remem¬ 
ber that you modified the file a week ago and removed the very infor¬ 
mation you're interested in? Or, have you ever spent hours sifting 
through dozens of inconsistently named copies of the same file trying 
to find one particular version? If you're like me, the answer is probably 
a resounding yes to both questions. Of course, if you're a programmer, 
you've probably already solved that problem in your development activ¬ 
ities by using a version control system like CVS or Subversion. What 
about everything else though? Mom's cherry pie recipe may not 
change as frequently as rpcjnit.c, but if you do decide to create a low- 
cal version, you're not going to want to lose the original. As it turns 
out, version control isn't only for source files anymore. Many of the 
features of Subversion make it ideal for versioning all kinds of files. 

With Subversion, you can keep a history of changes made to your files. 
That way, you easily can go back and see exactly what a given file con¬ 
tained at a particular point in time. You also save space, because it stores 
deltas from one version to the next. That way, when you make a change 
to a versioned file, it needs only enough extra space to store the changes 
rather than a complete second copy of the file. Also, unlike with CVS, 
delta storage on Subversion also applies to binary files as well as text files. 

Subversion makes it easy to access your files from multiple computers 
too. Instead of worrying whether the copy of the budget report on your 
laptop reflects the changes you made last night on your desktop system at 
home, you can simply run an update on your laptop and Subversion auto¬ 
matically updates your file to the latest version in the repository. Also, 
because all of the versions are stored in a single repository, there is a single 
location that you need to back up in order to keep all of your data safe. 

What to Version 

So your interest is piqued. You're sold on the advantages of versioning 
your files, and you'd like to give it a try. The first question to answer is 
what files you're going to put under version control. One obvious possi¬ 
bility would be to version your entire hard drive. In practice though, 
that's not a very practical approach. When you store a portion of a 
repository's contents locally (in what's called a working copy), Subversion 
stores a second copy of each file to allow it to compare locally changes 
you have made with the last version from the repository. Therefore, if 
you version the entire hard drive, you'll need twice as much hard drive. 

There's also little reason to keep full revision history on the largely static 
parts of your filesystem, such as /usr or /opt. On the other hand, directo¬ 
ries that contain a lot of custom files/modifications, such as /etc or /home, 
are prime candidates for versioning, because the advantage of tracking 
those changes is more likely to outweigh the disadvantages of extra stor¬ 
age requirements. Furthermore, with Subversion, you can opt to create a 
working copy from a subtree in the repository hierarchy. That way, you 


don't need to store any copies of infrequently accessed data locally, which 
often results in a net reduction in hard drive requirements, even though 
the files you are storing locally take up twice as much space. 

Getting Subversion Up and Going 

Now, let's dive in and get Subversion running on your machine. Installing 
is generally pretty easy. You can, of course, download the Subversion 
source and compile that, but in most cases, it's going to be much easier 
to install the precompiled binary package for your Linux distribution of 
choice. Fortunately, Subversion has matured to the point where such a 
package is available for almost every major distribution. In fact, I don't 
know of any off the top of my head that it isn't available for. 

Once you have Subversion installed, it's time to create a repository. 
Let's say you have a documents directory in your home that you'd like 
to version. First, you need to create a new empty repository using the 
svnadmi n create command. For instance, the following creates a 
new repository in your home directory: 

$ svnadmin create $H0ME/.documents_repository 

Next, you need to import your existing documents into the newly 
created repository. To do that, use the svn import command with the 
directory to import and a URL that points to the repository. In this 
example, the URL refers directly to the repository using a file://-type 
URL. If your repository will be used only locally, the file:// URL is the 
easiest way to access a repository (there are other, better ways to 
access repositories that I'll discuss in a bit though): 

$ svn import $HOME/documents file://$H0ME/.documents_repository 

When you run the import command, Subversion opens an editor and 
asks you for a log message. Whatever message you enter will be associated 
with the newly created repository revision and can be seen by examining 
the repository history logs. Enter something brief, such as "imported docu¬ 
ments directory". As soon as you save the log message and leave the editor, 
Subversion performs the import and outputs something like the following: 

Adding documents/filei.txt 

Adding documents/file2.txt 

Adding documents/file3.jpg 

Committed revision 1. 

You can now safely remove the original $HOME/documents and 
then re-create it as a working copy of the repository, using the svn 
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checkout command: 

$ rm -rf $HOME/documents 

$ svn checkout file://$H0ME/.documents_repository $HOME/documents 

So far, so good. However, if you want to take advantage of 
Subversion from multiple machines, you're going to need to set up a 
server. Several options are available to you, but the best choice is gen¬ 
erally to use Apache with mod_dav, which serves a Subversion reposi¬ 
tory using the WebDAV protocol. 

From a basic Apache installation, getting WebDAV to work is fairly 
simple. First, you need to make sure that mod_dav and mod_dav_svn 
are being loaded: 

LoadModule dav_module modul.es/mod_dav. so 

LoadModule dav_svn_module modul.es/niod_dav_svn. so 

Next, you need to set up a <Location> directive to point to your 
repository. For example, if you want your repository to be referenced 
with the URL http://example.net/bill/documents, and the repository is 
located in /srv/repositories/bill_documents, you could use the following 
Location directive: 

<Location /bill/documents> 

DAV svn 

SVNPath /srv/repositories/biH_documents 
AuthType None 
</Location> 

Or, if you want more security, you could allow for valid users only: 

<Location /bill/documents> 

DAV svn 

SVNPath /srv/repositories/biH_documents 

AuthType Basic 

AuthName "Bill's Documents" 

AuthUserFile /srv/repositories/bill_documents/passwd 
Require valid-user 
</Location> 

Basics of Using Subversion 

Now that you have Subversion set up, let's take a look at some of the 
basic commands you'll need to know. The basic command-line 
Subversion client program is called svn, and all of the client commands 
that you'll use are accessed through that program. To get a complete list 
of the commands that are available, you can run svn help. You can also 
run svn help [command] to get help on a particular command. 

The first basic command that you need to know is svn add. When 


you create a new file in a working copy, Subversion doesn't add it to the 
repository automatically. That way, you can control what gets versioned. 
For example, it usually would be a waste of space to add an emacs 
scratch file to your repository. Using svn add is easy. You simply need to 
give it the names of any files or directories to be added, and they will be 
scheduled for addition to the repository, assuming they reside inside of a 
valid working copy. Note though, that I said "scheduled". When you issue 
the svn add command, Subversion doesn't actually add the files to the 
repository yet. Instead, it schedules them to be added at the next commit. 
That way, you add multiple files with several svn add commands and still 
batch them together so that they are committed as a single revision, 
along with any already-versioned files that have been locally modified. 

So what's a commit? Well, when you modify files inside a working 
copy, the data isn't sent to the repository automatically. You need to 
commit your changes to the repository with svn commi t. The commit 
command performs the work of actually sending your local changes to 
the repository to create a new revision. Normally, if you're in the work¬ 
ing copy, you can simply issue svn commi t with no options, and it will 
recursively commit all changed files under your current directory. 
However, if you don't want to commit all of the local changes, you can 
specify only certain files by listing them on the command line. 

Once a file has been added to the repository, it can be freely modi¬ 
fied locally and Subversion automatically determines what changes 
have been made in order to send them to the repository when you 
perform a commit. There is a restriction though. You can't just copy, 
move or delete files with the standard cp, mv or rm commands. If you 
do, Subversion won't know about the change and will lose track of the 
file. Instead, you need to use the Subversion equivalents svn cp, svn 
mv and svn rm. Syntactically, they work about the same as the local 
versions that you're used to, but they also schedule their respective 
actions to be applied to the repository on the next commit. 

To find out the current status of a file in your working copy, you can use 
svn status. The status command shows you information such as which 
files are not under version control, which files have been modified and 
which files are scheduled for addition. For instance, the following output 
shows two modified files and one that hasn't been added to the repository: 

$ svn status 

? .GroceryList.txt.swp 

M Frogs.png 

M Groceryl_ist.txt 

You also can use the svn update command to update your working 
copy to the latest revision. If you're accessing only the Subversion reposi¬ 
tory from a single computer, updating isn't necessary. However, if files are 
being modified from multiple computers, you need to run svn update in 
your working copy to get any changes that have been committed from a 
different computer. 


CONNECTING FROM WINDOWS XP 



Whether you use it for games, work, placation of a less-technical spouse or just because you like it, the chances are pretty good that there's at least one Windows machine on your 
network. The good news is that Subversion was designed as a cross-platform application and is very well supported under Windows. Precompiled binaries of the command-line 
client are available from the Subversion downloads page. Additionally, there is an excellent GUI client for Windows that integrates with the Windows Explorer, called TortoiseSVN. 

Windows XP also supports autoversioning through WebFolders, although you'll want to use the old Explorer-extension version of WebFolders rather than the newer version 
that was introduced with WinXP, as the new version suffers from incompatibilities. To connect to a repository you simply need to add a new network place and enter the reposi 
tory URL, with the port number appended. For example, to connect to a repository at example.com/documents, you'd use the URL http://example.com:80/documents. 
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Autoversioning 

Now that I've explained the hard way of using Subversion to keep track of your files, let's take a look at 
autoversioning. When you use Apache as your Subversion repository server, it uses an extension of the 
WebDAV protocol for transferring files to and from the repository. An interesting side effect of this is that 
most operating systems can mount shared WebDAV directories as a network filesystem, much like Samba 
or NFS. That means you can mount a Subversion repository and directly access the files without needing to 
store them locally in a working copy. This can have several advantages that make it really nice for dealing 
with your personal files. For one, a new version is created every time a file is saved. That way, you have a 
complete save history of your files without worrying about whether you've done a commit recently. You 
also add files to the repository merely by creating them, and can do copies, moves or deletes with the 
standard filesystem commands. Furthermore, if you access your repository from multiple computers, you 
always know that you're accessing the most recent version without remembering to run svn update. 

Of course, autoversioning does have its downsides. For one, it requires a reasonably fast net¬ 
work connection to the computer that's serving the repository, so it may not be practical for a lap¬ 
top that's frequently used away from home; although if you have access to a network connection 
back to the server, it's always possible to copy files to your local hard drive, edit them and then copy 
them back to the repository. Another downside to autoversioning is that you can access only the 
most recent repository revision. If you want to access older revisions of files, you have to download 
them locally, which can be done either by checking out a directory at a specific revision: 

$ svn checkout -r 1563 http://$MY_SERVER/docs/pics/ 

or by using svn cat to download a single file: 

$ svn cat -r 1563 http://$MY_SERVER/docs/pics/beach . jpg 

If you're going to use autoversioning to mount your repository under Linux, you need to install 
davfs. Once it is installed, mounting the repository is easy. All you need to do is run mount.davfs, 
like in the following example, which mounts the repository $MY_SERVER/docs at /mnt/documents: 

$ mount.davfs http://$MY_SERVER/docs/ /mnt/documents 

Before you can use autoversioning though, you also have to turn it on in Apache. To do that, you 
need to add the SVNAutoversioning on option to your <Location> directive for the Subversion repository. 

Conclusion 

Subversion is a system with a large feature list, many of which I haven't even touched on. You 
should know enough now to get started with versioning your files though. I've been using it for my 
files for a while now and find it to be very helpful. I find it especially useful when used with 
autoversioning, which makes it an almost seamless integration with the filesystem. 

Resources for this article: www.linuxjournal.com/article/8751. ■ 


William Nagel is the Chief Software Engineer for a small technology company, and the author of Subversion Version Control: Using the Subversion 
Version Control System in Development Projects. He can be reached at bill@williamnagel.net. 


CONNECTING FROM OS X 


Okay, I admit it. I'm a Mac guy. As a Mac guy, my PowerBook gets a lot of use on my home network, so 
being able to access my files from there easily is pretty important to me. Fortunately, Subversion makes 
my life easy here. Subversion runs on OS X just as easily as it does on Linux, and it is a breeze to install. If 
you use the Fink package management system for installing open-source software on your Mac, you can 
install Subversion from there, or you can get standalone binaries. 

If you decide to take advantage of autoversioning, you'll also be very pleased with OS X. Mounting an 
autoversioned repository is as easy as selecting Connect to Server... from the Finder's Go menu and entering 
the repository's URL. The repository will be mounted in/Volumes, and it will appear on the desktop as a 
mounted network share. 
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Developing Eclipse Plugins 

A primer on getting started with Eclipse views, editors and plugins, mike mccullough 


This article presents a set of best prac¬ 
tices for use when developing Eclipse plug¬ 
ins for application development environ¬ 
ments built on the Eclipse platform. The 
general principles of plugin development 
outlined in this article can be applied to 
many other Eclipse-based development envi¬ 
ronments, in addition to the downloadable 
version. Several aspects of the Eclipse plugin 
development process are covered here, 
including the View versus Editor debate, the 
inside or outside choice, some standard wid¬ 
get toolkit (SWT) basics and the usefulness 
of the Eclipse Plugin Wizard. The advantages 
of using Eclipse for developing Eclipse plug¬ 
ins also are covered. The article also includes 
a walk-through of a simple application plug¬ 
in with an eye toward reuse across multiple 
Eclipse application plugins. 

The View vs. Editor Debate 

In Eclipse, the two basic ways of presenting 
any type of information to the user are 
with a View or an Editor. Both Views and 
Editors allow the user to select certain 
actions to be performed by the plugin by 
single- or double-clicking on an item, by a 
right-click pop-up menu or by a top-level 
pull-down menu item. 

The Editor class can do almost everything 
that the View class can do, plus a whole lot 
more. Allowing all this extra functionality 
comes at a price, however, in both system 
and code complexity. In general, the Editor 
class requires much more effort to develop 
than a View, so a certain amount of decision 
making must occur before embarking on an 
Editor implementation. 

Views are sufficient when simply provid¬ 
ing information to a user and allowing certain 
built-in capabilities is required. Users can 
input data to Views with relative ease usually 
by using other widgets in the SWT, such as 


tables and text boxes. But, what if you want 
more of a free-form interaction with the 
user? In addition, what if you want to have 
user inputs that are persistent across multiple 
launches of Eclipse? 

A good general guideline to use in this 
debate is the issue of persistence. Although 
it is possible to retain data from a View in 
some kind of persistent repository, in most 
cases this requires some level of work to be 
done in a file or file-like context. If this is the 
case, it often is easier simply to implement 
an Editor instead. 

The second most common consideration 
is the actual data being presented. If the 
user can select multiple data units and per¬ 
form actions using them or against them on 
a one-at-a-time basis, it usually is easier to 
implement the operation or operations as a 
distinct View. 

In this article, we implement a sample 
Eclipse plugin. This plugin has a simple goal: 
to provide generic application-level data to 
the user. This data is going to be represented 
as strings, although almost any data type 
could be substituted. The usual left-click, 
right-click and double-click actions are going 
to be enabled, but only double-clicking is 
modified as a reusable example for all other 
action implementations. 

As there is no immediate need for a per¬ 
sistent resource and as there will be multiple 
instances of data to select on a one-at-a-time 
basis, the sample plugin capability is going to 
be implemented as a View, which we simply 
call the DataView. 

The Inside or Outside Choice 

When implementing either Views or Editors, 
another decision must be made. Should the 
data be presented to the user within the 
actual Eclipse environment or outside of it 
somehow? The SWT provides Form classes 


that allow you to externalize your application 
data if you choose. 

Editors can be implemented either exter¬ 
nally or internally, but external Editors lack 
easy access to the plugin itself. Surprisingly, 
existing vendor plugins provide exactly this 
kind of functionality. In most of these cases, 
this is chosen because of the loss of plugin 
access as vendors decide to lock out the user 
from certain levels of Eclipse functionality. In 
general, the proper choice for plugin 
Editors—notwithstanding the user debate 
over openness in tools—is to implement 
Editors internally in Eclipse. It simply doesn't 
make much sense to lose access to the rest of 
the plugin if you don't have to. Now, what 
about Views? 

Similar to Editors, Views can be imple¬ 
mented either externally as a separate Form 
class or internally as a View with additional 
SWT widgets. There are no hard and fast 
rules here, but there are some basic guide¬ 
lines to follow when dealing with this deci¬ 
sion. In general, two things should be con¬ 
sidered. First, can the View data be 
described as unique and discrete entities, 
with fields or operations specific to that 
particular data item? Second, are there 
always less than about nine of these items? 
If so, the View can be implemented as a 
View with a Table or perhaps a View with 
separate Tabs for each discrete unit. 

If the actual number of instances of the 
data and the types of operations on that 
data is at all dynamic or unknown—for 
example, the developer does not know a 
priori exactly how many items there will be 
or exactly how many distinct operations to 
design or to allow for in the future—it 
probably is best to implement the View as 
an external Form class. 

The sample plugin developed in this 
article is a simple 100-item implementation 
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IN GENERAL, 
THE PROPER 
CHOICE FOR PLUGIN 
EDITORS— 
NOTWITHSTANDING 
THE USER DEBATE 
OVER OPENNESS 
IN TOOLS—IS 
TO IMPLEMENT 
EDITORS 
INTERNALLY IN 
ECLIPSE. 


Figure 1. To start a new plugin, select File—> 
New-Plug-in Project to bring up the Plugin Wizard. 


displaying data with only two distinct 
fields for each item, a name and a value. 
Although there are no predefined system 
requirements for more than nine multiple 
operations, there also are no explicit multi¬ 
ple operations defined. Therefore, you 
safely can assume that it will not require a 
great deal of them either—it is supposed 
to be simple after all. The DataView plugin 
therefore should be implemented as an 
internal View. 

Getting Started with the Eclipse 
Environment 

To start the actual plugin development, you 
need to start with an Eclipse installation. 

For this example, we downloaded the latest 
Eclipse version at the time of this writing, 
v3.0.2, from the Eclipse site. As we use the 
CDT plugin for C and C++ development 
extensively in our own organization, we 
then downloaded the CDT v2.1 Project. It 
can be accessed under the Eclipse Tools 
Project from the projects link on the main 
Eclipse page. You can download both of 
these as .zip files, which extract into a 
/eclipse directory. Therefore, make sure you 
install the Eclipse zip file prior to the CDT 
zip file. In our case, we were building on 
Red Hat Linux 9.0 using the GTK- version of 
both the Eclipse framework and the CDT 
plugin, but the Motif versions work equally 


as well. We then brought up Eclipse with 
./eclipse and selected the Plugin 
Development Environment (PDE) perspective 
from Window^Open Perspective. 

Using the Eclipse Plugin Wizard 

Many texts on Eclipse plugin development 
walk users through the Hello World type of 
project. It is this author's belief that 
although that might be a good start for 
novice programmers, it is absolutely the 
worst way for experienced software devel¬ 
opers to begin using Eclipse. It takes too 
long, and worst of all, much of the work 
has to be redone once you need to create a 
real plugin. Instead, we usually recommend 
creating as nearly complete a plugin project 
as possible, using as many pre-existing tem¬ 
plates as the environment allows. Doing so 
gives you a considerable amount of func¬ 
tionality immediately. You then can develop 
your own customizations of the existing 
functionality without worrying about being 
properly attached or hooked to the normal 
plugin-type environment. 

In the PDE, the Plugin Wizard allows a 
developer to create a sample plugin project 
quickly and easily, simply by selecting 
File^New^Plug-in Project. When prompt¬ 
ed for a name of the plugin, we use a com¬ 
mon syntax used by other commercial ven¬ 
dors. That is, we name the plugin with the 
text com.companyName.productName or in 
this example, com.mcc.dataView, as shown 
in Figure 1. 

It is easy enough to remove functionality 
from the plugin project once we get started 
on some actual customizations, so we select 
Next for two screens until we reach the 
Templates screen. We then select Create a 
plugin using one of the template's boxes and 
choose to use the Custom Plugin Wizard. 

You then select Next to see the templates to 
be created. 

You could remove specific functionality 
at this point, but for this exercise, we 
retain all functionality and simply keep 
selecting Next until we reach the Main 
View Settings window. In this window, we 
rename the Sample View as Data View, as 
shown in Figure 2. Once you have modi¬ 
fied this window appropriately, you can 
select Finish or cycle through the last of 
the customization sections, which is View 
Features. You can move forward and back 
during this process, so take your time. No 
changes are made to the environment until 
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the Finish button is selected. 

If you mess it up the first time, as this 
author did, don't hesitate to delete the entire 
project including the directory contents and 
start again until you get it right. Once the 
plugin has been created to your exact tem¬ 
plate specifications, you are ready to execute 
the plugin for the first time. For this we use 
the run-time workbench. 

Testing the Plugin Using the 
Run-time Workbench 

One of the most attractive features of the 
Eclipse framework is its own ability to 
develop, test, debug and execute plugins in 
the run-time workbench. Few development 
environments provide exactly this kind of 
functionality in such an easy-to-use and 
intuitive fashion. This removes many of the 
time-wasting impediments to developers 
stuck in the long compile-build-debug cycle 
typical of other development environments. 

To execute the DataView plugin, simply 
select Run^Run As-^6 Run-time work¬ 
bench from the PDE perspective. The 
Eclipse PDE spawns a completely separate 
user workspace, called the run-time 
workspace, and executes the DataView 
plugin. On the first execution of the plugin, 
you need to select the Window^Show 
View-^Other top-level menu pull-down, 
and choose the DataView listed under the 
specific Views heading that you selected 
during plugin creation. 

In future executions, the run-time work¬ 
bench functions much as the regular 
workspace functions and retains the appro¬ 
priate View layout between multiple launch¬ 
es. This greatly simplifies testing, as re-testing 
is only a matter of running the run-time 
workbench again. 

One of the few drawbacks to the run¬ 
time workbench model is its rough doubling 
of host RAM usage due to executing the 
equivalent of two Eclipse sessions on a single 
machine. In systems with limited RAM, such 
as laptop environments, this can be a bit slow 
and frustrating. As JVMs improve, though, 
this problem does get better. 

Experiment with the sample plugin 
menus and pull-downs to get a feel for 
what functionality you have created. Even 
though we don't discuss Editor customiza- 
tions in this article, you also might want to 
experiment with creating a simple Eclipse 
project and then creating a new file with a 
.mpe extension. Doing so allows you to get 


familiar with the concept of multipage edi¬ 
tors similar to the one used for displaying 
the plugin.xml file now listed under your 
new plugin project. 

Customizing the Plugin View 

The first step in customizing the DataView 
is to add a new ViewLabelProvider class to 
the plugin project under the Views folder. 
This allows you to add data to the table to 
be displayed in the DataView window 
when the plugin is executing. The 
ViewLabelProvider interacts with the 
ParameterControl class by providing the 
data stored there, a Name and a Value, to 
the DataView. A complete listing of this 
class can be found in the project tar file. 

The next step in customizing the 
DataView is to add the ParameterControl 
class that is referenced by the 
ViewLableProvider class to the plugin pro¬ 
ject under the Views folder. This class 
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maintains the actual parameter names and val¬ 
ues to be displayed in the DataView table. 
Although a relatively simple implementation, it 
easily can be scaled to a greater number of 
fields if necessary. A complete listing of this 
class also can be found in the project tar file. 

The third step in customizing the DataView 
is to add a Table with the appropriate settings 
to the DataView class (see Listing 1 on the 
Linux Journal FTP site), modify the Plugin class 
itself to support the UserParameter variable and 
customize the Doubleclick action to display the 
table entry data. Note the addition of a new 
function called UpdateTheTable that provides 
the latest data to the Table. This function would 
be the modification point for new application 
data by way of the filesystem or network or 
whatever. For this example only, the first four 
parameters are modified for new data. The full 
code for our plugin is available from the Linux 
Journal FTP site (see the on-line Resources). 

The final modification is to add a 
ParameterControl variable and its initialization 
to the plugin itself. This is done by adding the 


variable declaration to the DataViewPlugin.java 
file, at the first point after the resourceBundle 
is declared. The variable declaration should be 
as follows: 

//User Parameter functionality 
public ParameterControl userParameters[] = 
new ParameterControl[100]; 

Next the initialization section is added at the 
end of the Plugin constructor as shown: 

// Additions for User Parameter functionality 
int index; 

for (index = 0; index < 100; index++) 

{ 

userParameters[index] = 

new ParameterControl("Parameter " 

+ (index + 1), "Value " + (index + 1)); 

} 

The final run-time workbench execution of 
the plugin is shown in Figure 3. In the figure, 
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Figure 3. The plugin is finished and responding to user input. 


the user has double-clicked on an item, 
producing a simple user dialog that 
displays the actual data for the table 
selection made. 

Conclusion 

In this article, we discovered some basic 
rules to follow when making decisions about 
how an Eclipse plugin should present appli¬ 
cation data to a user by way of an Eclipse 
View. We have utilized the Eclipse Plugin 
Wizard to auto-generate much of the plugin 
initialization code in a testable and reusable 
format. We also have reviewed certain usage 
examples of the SWT, including Tables, 
Viewers and LabelProviders, and their uses 
in the context of a User View. Finally, we 
have seen some of the advantages and 
disadvantages of using the run-time work¬ 
bench feature of Eclipse. 

Along the way, we created a relatively 
simple sample plugin that can be used 
over and over again as a starting point for 
new Eclipse plugins. The sample plugin 
easily accommodates future growth in the 


plugin itself by enabling all typical plugin 
functionality, such as multipage editors, 
properties, wizards and reference exten¬ 
sions. This additional plugin functionality 
now can be implemented in an iterative 
fashion, allowing not only for future 
growth of the specific plugin but easier 
reuse across multiple plugin developments. 
It also can serve as a starting point for new 
developers with little or no prior knowl¬ 
edge of Eclipse development. This reusabil¬ 
ity aspect is one of the most compelling 
features of the Eclipse framework. 

Resources for this article: 
www.linuxjournal.com/article/8789. ■ 
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Separation of Church and Choice 

When did “choice” become the god of the Open Source community? 


I recently lodged several criticisms of GNOME 
in Linux Journal's sister publication TUX 
(www.tuxmagazine.com), GNOME fans were 
outraged, of course. I find it telling that none 
of them even attempted to explain why the 
GNOME way of doing things was better than 
KDE or any other competing desktop. 

The closest thing I saw to a defense for a 
GNOME feature was the argument that 
"Microsoft plans to do it the same way in the next 
version of Windows." The claim wasn't strictly 
true, but that is beside the point. You can read 
last month's rant if you want to know what I think 
NICK PETRELEY, EDITOR IN CHIEF of the "monkey see Microsoft, monkey do 

Microsoft" mentality that is infecting the Open 
Source community. 

But, the most confounding response to my criti¬ 
cisms of GNOME was that "You should stop bash¬ 
ing GNOME and praise it because it offers desktop 
users yet another choice." 

Let me be clear that what follows is not a rant 
about GNOME. (Relax, I'll get to that column all in 
good time.) This is a rant about defending anything 
based solely on the fact that it adds another choice 
for users. This is a very popular defense. I've seen it 
leveraged against criticisms of many other things in 
the Linux universe, not only GNOME. 

Let me be equally clear that I don't care whether 
you use GNOME, KDE, Xfce, Blackbox, Fluxbox, 
Fuzzbox, Jackinthebox, Window Maker, 
Enlightenment, Fvwm, IceWM, Twm, Ratpoison, Ion 
or any of the other gazillion desktops or window 
managers. I like several of the above, depending 
upon my needs at the time, but I will not lose a 
wink of sleep over the fact that you prefer some¬ 
thing other than what I like. Neither will I be the 
least bit offended if you disagree with what I believe 
about what is best in the narrower field of full-fea¬ 
tured desktops. 

But the fact that we're both entitled to our 
opinions doesn't mean there isn't an objective stan¬ 
dard against which we can measure our opinions. 
There is. And, even the nastiest of letters I received 
about my criticisms of GNOME proved that my opin¬ 
ions came closer to that objective standard than the 
opinions of those who disagreed with me. How can 
I make such a bold assertion? Easy. First, as I said, 
nobody really offered any logical defense that any¬ 
thing in GNOME was better than the competition. 
One has to wonder why not, if GNOME is such a 



great desktop? 

More telling is the fact that almost all (if not all) of 
those who disagreed with my criticism of the Nautilus 
"spatial" file manager couldn't respond to specific 
questions or complaints because they don't use 
Nautilus in spatial mode. What a way to bolster your 
case, eh? I don't like it enough to use it, but stop crit¬ 
icizing it because, like GNOME itself, it is a choice. 

GNOME is a choice besides what? KDE, Xfce, 
Blackbox, Fluxbox, Window Maker and so on? The 
last time I looked, it didn't seem like the progress of 
Linux was roadblocked by the lack of another desk¬ 
top or window manager. So what is the source of 
this notion that something has inherent value based 
solely on the principle that it provides users with yet 
another choice? 

If I were a restaurant critic, and I happened upon 
a restaurant that based all its recipes on rat feces, you 
can count on the fact that I would not defend or 
praise this restaurant on the sole basis that the dining 
public could choose it over McDonald's or Ruth's 
Chris. Crap is crap, and there's no way I'm going to 
say anything positive about a restaurant that features 
it on the menu. I don't care what kind of platters the 
restaurant uses to serve it up. 

Granted, that doesn't mean people won't 
patronize a restaurant of this kind. There's no 
accounting for taste, an axiom proved by the fact 
that there are any GNOME users at all. But let's not 
pretend crap is filet mignon in order to appease the 
god of choice. If a god of choice did actually exist, I 
have my doubts that we'd find him dining on rat 
feces in order to glorify his name. And no "God 
uses GNOME" letters, please. That's too easy. 

The bottom line is this, and it applies to every bit 
of software, not just GNOME. If you can't defend its 
design, or you find out its users turn off the very fea¬ 
tures you claim make it great, then here's my advice. 
Either go back to the drawing board and make it 
really great instead of theoretically great, or just deep- 
six it once and for all. Cremate it and scatter the 
ashes somewhere they won't stink up the rest of the 
software base. But don't come to me and defend it 
based on the fact that it gives users a choice. You'll 
find no sympathetic ear here. 

Yeah, but what do I really think? ■ 


Nicholas Petreley is Editor in Chief of Linux Journal and a former 
programmer, teacher, analyst and consultant who has been working with 
and writing about Linux for more than ten years. 
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Rackspace - Managed Hosting Backed by Fanatical Support™ 


Fast servers, secure data centers and maximum bandwidth are all 
well and good. In fact, we invest a lot of money in them every year. 
But we believe hosting enterprise class web sites and web 
applications takes more than technology. It takes Fanatical Support. 

Fanatical Support isn't a clever slogan, but the day to day reality our 
customers experience working with us. It's how we have reimagined 
customer service to bring unprecedented responsiveness and value 
to everything we do for our customers. It starts the first time you 
talk with us. And it never ends. 

Contact us to see how Fanatical Support works for you. 

1.888.571.8976 or visit www.rackspace.com 



Thanks for honoring us with the 

2005 Linux Journal Readers 1 Choice Award for 

"Favorite Web-Hosting Service" 
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InfiniBand Switch 


From a Company You've Trusted for 23 Years 



Microway's FasTree" DDR InfiniBand 
switches run at 5GHz, twice as fast as the 
competition's SDR models. FasTree's 
non-blocking, flow-through architecture makes 
it possible to create 24 to 72 port modular 
fabrics which have lower latency than 
monolithic switches. They aggregate data modulo 
24 instead of 12, improving nearest neighbor latency in fine grain problems 
and doubling the size of the largest three hop fat tree that can be built, from 288 to 576 A 72 p or t FasTree" Configuration 

ports. Larger fabrics can be created linking 576 port domains together. 


Working with PathScale's InfiniPath HTX Adapters, the number of hops required to move MPI messages between nodes is 
reduced, improving latency. The modular design makes them useful for SDR, DDR and future QDR InfiniBand fabrics, greatly 
extending their useful life. Please send email to fastree@microway.com to request our white paper entitled Low Latency Modular 
Switches for InfiniBand. 


Microway's QuadPuter® includes four AMD single or dual core Opteron™ processors, 1350 Watt redundant power supply, and 
up to 5 redundant, hot swap hard drives-all in 4U. Dual core enables users to increase computing capacity without increasing 
power requirements, thereby providing the best performance per watt. Constructed with stainless steel, QuadPuter’s 
RuggedRack™ architecture is designed to keep the processors and memory running cool and efficiently. Hard drives are cooled 
with external air and are front-mounted along with the power supply for easy access and removal. The RuggedRack™ is also 

available with an 8-way motherboard and up to 128 GB of memory for power- and 
memory-hungry SMP applications. 





Call us first at 508-746-7341 for quotes 
and benchmarking services. Find 
technical information, testimonials, and 
newsletter at microway.com. 


4 QuadPuter® Navion™ with hot swap, redundant power and hard drives 
and dual core Opterons, offering the perfect balance between 
performance and density 
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Opteron 


PathScale 



Accelerating 
Cluster Performance™ 



508.746.7341 microway.com 




























Let’s go ^ *treme 


Introducing Appro XtremeServers & Workstation 
with 8 DIMM Sockets per CPU 


■ 2-way or 4-way, Single or Dual-Core AMD Opteron™ processors 

■ Largest memory capacity - 8 DIMM Sockets per CPU, up to 128GB 



PCI-Express technology to increase I/O bandwidth and reduce system latency 
Outstanding Remote Management - IPMI 2.0 compliant 
Cable-free design, ready to run, simple to install, service and maintain 
Support for Windows® or Linux OS 
Ideal for memory-intensive and l/O-intensive applications 


1U / 2U / 3U Servers 
and Workstation 


AMD Opteron™ Processors - AMD64 dual-core technology reduces memory latency and increases data throughput 
- Dual-core processors with Direct Connect Architecture deliver the best performance 
per watt with little or no increase in power consumption or heat dissipation. 



HPC Cluster Solutions 


Appro delivers high-performance computing solutions to help you maximize productivity 
for a solid ROI. On-site maintenance and installation services are also available. 

For more information, please visit www.appro.com 
or call Appro Sales at 800.927.5464, 408.941.8100. 
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